<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<link href="../css/docs.css" type="text/css" rel="stylesheet" />
<link href="../css/prettify.css" type="text/css" rel="stylesheet" />
<script src="../js/prettify.js" type="text/javascript"></script>
</head>
<body onLoad="prettyPrint()">
<div class="g-unit" id="doc-content">
<div id="api-info-block">
    <div class="api-level">H3C CAS云管理平台</div>
  </div>
  <div id="jd-header">
    <h1>修改虚拟机CPU配置</h1>
  </div>
</div>
<div id="jd-content">
<div class="jd-descr">
<p>修改虚拟机CPU配置，包括虚拟机个数和核数分配，绑定物理CPU。</p>
<h2><a name="uri"></a>接口 URI</h2>
<p>/cas/casrs/vm/modify</p>
<h2><a name="access"></a>访问方法</h2>
<dl>
  <dt><b>HTTP 方法</b></dt>
  <dd>PUT</dd>
  <dt><b>消息体</b></dt>
  <div class="source">
  	<pre class="prettyprint lang-xml">&lt;domain&gt;<br>    &lt;id&gt;6&lt;/id&gt;<br>    &lt;name&gt;test&lt;/name&gt;<br>    &lt;cpu&gt;<br>        &lt;cpuSockets&gt;1&lt;/cpuSockets&gt;<br>        &lt;cpuCores&gt;2&lt;/cpuCores&gt;<br>        &lt;cpuShares&gt;256&lt;/cpuShares&gt;<br>        &lt;cpuArch&gt;i686&lt;/cpuArch&gt;<br>        &lt;cpuMode&gt;host-model&lt;/cpuMode&gt;<br>        &lt;cpuQuota&gt;1&lt;/cpuQuota&gt;<br>        &lt;cpuQuotaUnit&gt;GHz&lt;/cpuQuotaUnit&gt;<br>        &lt;cpuGurantee&gt;10&lt;/cpuGurantee&gt;<br>        &lt;bindcpu&gt;<br>            &lt;vcpu&gt;0&lt;/vcpu&gt;<br>            &lt;pcpu&gt;0&lt;/pcpu&gt;<br>            &lt;pcpu&gt;1&lt;/pcpu&gt;<br>        &lt;/bindcpu&gt;<br>        &lt;bindcpu&gt;<br>            &lt;vcpu&gt;1&lt;/vcpu&gt;<br>            &lt;pcpu&gt;0&lt;/pcpu&gt;<br>        &lt;/bindcpu&gt;<br>    &lt;/cpu&gt;<br>&lt;/domain&gt;</pre>
  </div>
</dl>

<dt><a name="detail"></a><b>元素含义</b></dt>
  <table id="pubmethods" class="jd-sumtable">
    <tbody>
      <tr>
        <th colspan="2"><span class="prettyprint lang-xml">domain</span>各子元素</th>
      </tr>
      <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">name</span></td>
        <td width="100%" class="jd-linkcol"><span class="sympad">虚拟机名称。</span>
          <div class="jd-descrdiv">字符串（String）类型，必须。</div></td>
      </tr>
      <tr  class="alt-color">
        <td class="jd-typecol"><span class="prettyprint lang-xml">id</span></td>
        <td class="jd-linkcol"><span class="sympad">虚拟机id。</span>
          <div class="jd-descrdiv">长整型（Long）类型，必须。</div></td>
      </tr>
      <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpu</span></td>
        <td class="jd-linkcol"><span class="sympad">虚拟机CPU配置。</span>
          <div class="jd-descrdiv">自定义类型，必须。</div></td>
      </tr>
    </table>
	<table id="pubmethods" class="jd-sumtable">
    <tbody>
      <tr>
        <th colspan="2">cpu各子元素</th>
      </tr>
      
      <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuSockets</span></td>
        <td width="100%" class="jd-linkcol"><span class="sympad">CPU个数，最小值为1，最大值由主机实际情况决定。</span>
          <div class="jd-descrdiv">整型（Integer）类型，必须。</div></td>
      </tr>
      <tr  class="alt-color">
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuCores</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU核数，最小值为1，最大值由主机实际情况决定。</span>
            <div class="jd-descrdiv">整型（Integer）类型，必须。</div></td>
      </tr>
      <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuShares</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU调度优先级，枚举值：1024：高，512：中，256：低。</span>
            <div class="jd-descrdiv">整型（Integer）类型，必须。</div></td>
      </tr>
	  <tr  class="alt-color">
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuMode</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU工作模式，取值为：custom、host-model、host-passthrough。</span>
            <div class="jd-descrdiv">字符串（String）类型，可选项。</div></td>
      </tr>
	  <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuArch</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU体系结构，取值为：x86_64、i686。</span>
            <div class="jd-descrdiv">字符串（String）类型，可选项。</div></td>
      </tr>
	  <tr  class="alt-color">
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuQuota</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU周期限制值</span>
            <div class="jd-descrdiv">小数（double）类型，可选项。</div></td>
      </tr>
	  <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuQuotaUnit</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU周期限制 单位，取值为MHz,GHz</span>
            <div class="jd-descrdiv">字符串（String）类型，可选项。</div></td>
      </tr>
	  <tr  class="alt-color">
        <td class="jd-typecol"><span class="prettyprint lang-xml">cpuGurantee</span></td>
        <td class="jd-linkcol"><span class="sympad">CPU预留，单位：MHz</span>
            <div class="jd-descrdiv">长整数（long）类型。，可选项。</div></td>
      </tr>
	  <tr>
        <td class="jd-typecol">bindcpu</td>
        <td class="jd-linkcol"><span class="sympad">虚拟CPU绑定物理CPU配置。</span>
            <div class="jd-descrdiv">自定义类型，可选项。</div></td>
      </tr>
  </table> 
  <table id="pubmethods" class="jd-sumtable">
    <tbody>
      <tr>
        <th colspan="2">bindcpu各子元素</th>
      </tr>
      
      <tr>
        <td class="jd-typecol"><span class="prettyprint lang-xml">vcpu</span></td>
        <td width="100%" class="jd-linkcol"><span class="sympad">指定虚拟CPU，0：表示第一个虚拟CPU，1：表示第二个虚拟CPU，依次类推。</span>
          <div class="jd-descrdiv">整型（Integer）类型，必须。</div></td>
      </tr>
      <tr  class="alt-color">
        <td class="jd-typecol"><span class="prettyprint lang-xml">pcpu</span></td>
        <td class="jd-linkcol"><span class="sympad">指定物理CPU，0：表示第一个物理CPU，1：表示第二个物理CPU，依次类推。</span>一个虚拟CPU可绑定多个物理CPU。
          <div class="jd-descrdiv">整型（Integer）类型，必须。</div></td>
      </tr>
  </table>

<h2><a name="result"></a>返回结果</h2>
<dl>
  <dt><b>状态码</b></dt>
  <dd>
  <ul>
    <li>204(No Content)：成功。</li>
    <li>409(Conflict)：失败。 </li>
  </ul>
  </dd>
  <dt><b>消息头</b></dt>
  <div class="source"><pre class="prettyprint lang-xml">HTTP/1.1 204 No Content<br>Server: Apache-Coyote/1.1<br>Date: Mon, 25 Nov 2013 12:52:27 GMT
  </pre>
  </div>
  <dt><b>消息体</b></dt>
  <div class="source">
    <pre class="prettyprint lang-xml">HTTP/1.1 200 OK<br>Server: Apache-Coyote/1.1<br>Set-Cookie: JSESSIONID=BDF7B4EDFDBA9FBF003D195F802D705F; Path=/imcrs<br>Date: Fri, 23 Dec 2011 04:44:21 GMT
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>&lt;taskMsg&gt;<br>  &lt;msgId&gt;1393831560400&lt;/msgId&gt;<br>  &lt;name&gt;修改虚拟机“test”CPU个数2 --&gt; 2、CPU工作模式Host Model --&gt; Host Model、体系结构i686 --&gt; i686、CPU调度优先级低 --&gt; 低、CPU预留10MHz --&gt; 10MHz以及CPU周期2.0GB --&gt; 2.0GHz成功。&lt;/name&gt;<br>  &lt;detail&gt;修改虚拟机“test”CPU个数2 --&gt; 2、CPU工作模式Host Model --&gt; Host Model、体系结构i686 --&gt; i686、CPU调度优先级低 --&gt; 低、CPU预留10MHz --&gt; 10MHz以及CPU周期2.0GB --&gt; 2.0GHz。&lt;/detail&gt;<br>  &lt;completed&gt;false&lt;/completed&gt;<br>  &lt;progress&gt;0&lt;/progress&gt;<br>&lt;/taskMsg&gt;</pre>
  </div>
</dl>
<dt>
    <h2><a name="example"></a>应用举例</h2>
    <p>修改虚拟机test的CPU配置，绑定第一个虚拟CPU到第一个和第二个物理CPU。</p>
    <dl>
      <dt><b>请求</b></dt>
      <div class="source">
        <pre class="prettyprint lang-xml">POST http://192.168.0.4:8080/cas/casrs/vm/modify
accept: application/xml


&lt;domain&gt;<br>    &lt;id&gt;6&lt;/id&gt;<br>    &lt;name&gt;test&lt;/name&gt;<br>    &lt;cpu&gt;<br>        &lt;cpuSockets&gt;1&lt;/cpuSockets&gt;<br>        &lt;cpuCores&gt;1&lt;/cpuCores&gt;<br>        &lt;cpuShares&gt;256&lt;/cpuShares&gt;<br>        &lt;cpuArch&gt;i686&lt;/cpuArch&gt;<br>        &lt;cpuMode&gt;host-model&lt;/cpuMode&gt;<br>        &lt;cpuQuota&gt;1&lt;/cpuQuota&gt;<br>        &lt;cpuQuotaUnit&gt;GHz&lt;/cpuQuotaUnit&gt;<br>        &lt;cpuGurantee&gt;10&lt;/cpuGurantee&gt;<br>        &lt;bindcpu&gt;<br>            &lt;vcpu&gt;0&lt;/vcpu&gt;<br>            &lt;pcpu&gt;0&lt;/pcpu&gt;<br>            &lt;pcpu&gt;1&lt;/pcpu&gt;<br>        &lt;/bindcpu&gt;<br>    &lt;/cpu&gt;<br>&lt;/domain&gt;
</pre>
      </div>
      <dt><b>回应</b></dt>
      <div class="source"><pre class="prettyprint lang-xml">HTTP/1.1 200 OK<br>Server: Apache-Coyote/1.1<br>Set-Cookie: JSESSIONID=BDF7B4EDFDBA9FBF003D195F802D705F; Path=/imcrs<br>Date: Fri, 23 Dec 2011 04:44:21 GMT
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>&lt;taskMsg&gt;<br>  &lt;msgId&gt;1393831560400&lt;/msgId&gt;<br>  &lt;name&gt;修改虚拟机“test”CPU个数2 --&gt; 2、CPU工作模式Host Model --&gt; Host Model、体系结构i686 --&gt; i686、CPU调度优先级低 --&gt; 低、CPU预留10MHz --&gt; 10MHz以及CPU周期2.0GB --&gt; 2.0GHz成功。&lt;/name&gt;<br>  &lt;detail&gt;修改虚拟机“test”CPU个数2 --&gt; 2、CPU工作模式Host Model --&gt; Host Model、体系结构i686 --&gt; i686、CPU调度优先级低 --&gt; 低、CPU预留10MHz --&gt; 10MHz以及CPU周期2.0GB --&gt; 2.0GHz。&lt;/detail&gt;<br>  &lt;completed&gt;false&lt;/completed&gt;<br>  &lt;progress&gt;0&lt;/progress&gt;<br>&lt;/taskMsg&gt;</pre>
      </div>
    </dl>
    
</div>
</div>
</div>
</body>
</html>